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■ Abstract ^ ■ 

This^s a brief destription of the pHmitlves in PDP 11 LOGO. It is intended 
to provide a quick reference for users wito are alreacly familiar with LOGO basics. 
For a more detailed and iKomprehensive description of LOGO, consult the LOGO Manual 
(A.I. Memo 313, LOGO Memo 7). " 
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A Glossary oT LOGO Primitives 

This^ia a brief description of the primitives in POP 11 LOGO* It^ is 
intended to provide a quick reference for usisrs who are already familar 
uTVh LOGO basics. For a more detailed and comprehensive description of ^ 
LOGO, consult the LOGO flanual (LOGO HEUO No. 7). 

LOGO primitives ^re generally divided Into operations (whjch 
output) arid commands (which don't). There are also special modifying 
words, whrich are only used in combination witH certain other primitives, 
and noise words. Noise words are optional and generally do not affect the 
evaluation of the LOGO expression in which they appear (as long as they are 
in the right place!), but can be used to make tha syntan of the enpression 
more I ike Engl ish. 

Special modifying word. AlloO^the ueer to reference all enieting 
items of a given tyiie wijth a single command. See, for eicample, ERASE ALL 
and PRINTOUT ALL. • 

^ ALSO ^ . . .u 

Takes one input, the name of a device. This command allows the ^ 
user to control more than one device at a time on LOGO. For example, in 
.order to use both a display and a floor turtle, type 

' CLEARSCREEN . 

ALSO TURTLE <number> 
The CNTRL bommand is used to specify which device the following 
commands will refer to (if this is not used, the default- value is the fir^st 
device that you '*cwned"). 

.AND - • 
• Noise word. Usedvto separate inputs to a procedure as In: 

sun OF 3 AND 4 

ASIZE / ^ ^. . . 

Takes one input, the name of an arrayt and outputs the dimensions 

of the array. 

BACK,(BK) - • . . ^ 

Takes one input. Commands the display or floor turtle to move 
backwards the number of units designated by the input. . 

BELL' ' " \ 

Takes\no inputs. It* rings the bell on the conso.le. 

* BOTH ■> ^ J r*i cc 

Takes two inputs and outputs TRUE if botli inputs are true and FALSE 
if one or botb are false. Eacli input must^be a conditional (evaluate to • 
either TRUE or FALSE). . * 



s 
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BTQUCH ' . 

/Takes no Inputs. It chiscks the back touch sensor on the floor 
turtle, and outputs TRUE if it has been activated, FALSE otherwise. ' 

BURY . ' 

TakiBs one input, d pT^oced.ure nane, and effectively "hides'* that 
procedure in the uorkepace. For encamp le, the buried procedure '*F00** Mill 
not be printed in PO ALL cqnmiandsf norruill it be af.f^ted by any procedure 
commands not -exp I ic it ly directed to it« This protects it from accidental 
deletion thr^ough ERASE A{.L. To reference a buried procedure, the name of 
the procerlure mu^t be specified explicitly in the command, as in POP "FOQ' ' 
or ERASE TOO. \ ^ ' 

/To unbCiry a procedure, ERASE BURY <procedure> is used- BURY also 
accepis ALL as an in|;ut« in uhich case all the proceduref in the uorkspace 
wi 1 1 dU buried. - ' * 

BUTFIRST (BP) , / 

Takes one \nput. if the input is a list« outputs all tnit the first 
uord of the list. If the input is a uord, outputs all but the first 
character, of the word. ^ 

BUTFIRST -JOHN outputs OHN 

BUJFIRST [JOHN MARY PAUL] outputs irtARY PAUL! j 

BUTLAST fBL) . . " ' 

Takes one input, a uord, or list. If^a uord, outputs all but the 

last letter of the uord; If a^ list, outputs all but the last Word of the . 

list. * ■ . 

BUTLAST ••HARRY outputs HARR . " : 

BUTLAST [THE NEU BlCYCLEl outputs ITHE NEW 

.CASESU ' ^ ^■ 

Jakes*.no inputs. If you are u^ing a terminal uith. louer^case 
characters, LOGO normaHy translates I ouer c^se into upper 'Mse* «CASESU 
suitches this feature offhand on^ 

CLEARSCREEN (CS)' " ■ ' 

Takes no inputs. Commands the computer to clear the display 
screen. It also returns the display turtle to its original-position at the 
center of the screerr [0,01, and pointing straight up (HEADING 0). 

.CLOCK 

Takes no inputs. Outputs a number uhich is incremented 

approximately every l/S0th of a second. 

* 

.CLOSE. • ' . . ^ 

^ ' Takes one input, a device specif 1 pat ion (see .TYO), «nd releases 

that device from, tVe curent, user's control, so that another user may access 

it., ^ *> 



^CLOSEF 
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Takes no inputs. Closes the file currently open (no nope' than one ' 
file can be open af a timeK Tf no files are open, the conMand is ignored. 
See .GPENR and .OPENU. 

CNTRL 

Uhen a user is contolling more than ohe device, the CNTRL command 
specifies the device to uhich a given coniiiand. rs directed. Takes one 
input, the name of a device the user currently "owns", and specifies that 
device as the object of the next command typed. All commands will be 
directed to this device until another CNTRL command it typed. See also 
ALSO. 

CONTENTS 

* No inputs. Outputs a list containing the titles of all proceduree 
in the workspace. . . 

CONTINUE (CO) ^ . 

Takes no inputs. Continues the execution of a procedure that ie 
currently PAUSEd, starting at the next lijne. (See PAUSE). 

COS ^ ' 

Takes one numeric input, and returns the cosine of the angle of 
<input> degrees. 

'COUNT 

Takes one input, a word or a list. If the input is a list, outputs 
the number of words in the list. If it is a word, outputs the number of 
characters in the word. 

• COUNT "ELEPHANT outputs 8 
Um\ t L E PHANT ) outputs 3 

CRINOEX V , ' V 

CRINOEX is use^ to create an index in thb fSsTl^ng system (see 
INDEX).. ' It takes one argument, the name of the index to be created. This 
index is added onto the braocb of the filing tree specified by the previous 
USE command. If the input is as, list, however, the index may be even 
•farther down the tree. See SETINDEX. 

.CTYI \ 

Takes no inputs.^ Outputs the character code of the next character 
typed in at the user's console. ^ » 

\ ' . . * 

'.CTYO ^ .V 7^ 

Takes one numeric input which specifies a character code. This./ 

character is printed 4s output on the user's console* ^ 

CTY(^AIT ' . . 

Used to cause LOGO to UAIT a until a console has finished typing 
out. Normally takes no inputs, in which case the pause ends as soon as the, 
console has finished its output. If an input is yiven, this is an 
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additional amount of time for LOGO to uait after the console has finished* 

■ •<> ■ ^ ' '■ "'"^ 

D^TE • ^ ' ^ ^ 

Takes no inputs. Outputs a list of 3 elements uhich Is 

W/OAY/YEARt Currently uniinplemented. ^ . 

DEBUG 

Takes no inputs. Switches the debuggin]^ system on and t>f f . Uhen 
* the system is on» errors cSuse a PAUSE rather t^tn a BREAK to the top- 

leN^el. During this'^pause* the user may^extcute any LOGO commands and then 
contintie execution by using the CONTINUE command. 

•* ^DEFINEARRAY (DEFAR) 

This cofnmand is used to create an array. Depending on trn number 
of dimensions of. the array* OEFINEARRAY takes up to five inputs* in this 
order: the array name,, the dimensions of the array* and th« array type (0 
/ for integer* 1 for floating point, 2 for pointer). Up to three dimensions 

are alloued. If the array has more than one dimension* DEFINEARRAY must ba 
treated as having a variable number of inputs* i.e. the command and its 
inputs must be enclosed in' parentheses. 

DIFFERENCE 

Takes tuo Inputs, uhich^must be numbers* and outputs their 
difference (subtracts the second from the first). « 
DIFFERENCES 1 outputs 2 

DISPLAY J 

Takes one input uhich must be a SNAP ^i.e*, something created by 
the SNAP operation) and shous it on the screen at a lipcatlon determined by 
the current position of the turtle* The, SNAP aluays ippears in the 

orientation in uhich it uas originally draun* * ^ 

.ECHOSU . . \ 

Takes no inputs. Turns off and on a feature, uhich inhibits, the 
echorngoof characters typed at the console. 

& 

O ' »• 

.EDIT (ED) V ' 

\ Takes one input* the name of a procedgre* and putd the user in ^ 

editing mode. Allous the user to change the definition of the specified 
procedure. Uhen done iscjLiling, type END to get out of editing mode. 

EDIT LINE (EOL) ' ' 

Takes one' input* the line number of a procedure. Talli the 
computer uhich tine in a procedure you wish to edit. The specified line is 
^ put into the edit bluffer uhere it can be lyaNiipuiated using the specfial 

control characters for edi'ting (see EOIJfNG CHARACTERS near the end of this 
glossary). EOlt LINE can be used only uhen defining or editing a 
procedure. ^ 

EDIT TITLE (EOT) x . 
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LOGQ GLOSSARY *PAGE'^ 5 



Ik. 

4:>. - 



Take» no Vnputft b(*t putt tht ti t it of <h« proctdurtr,currently 
i%\t\q dtfined/«dited into thtltdit bufflfr^ i4hfrtjKcan bt changtd utinB 
the editing control <;haracttrs. Or tht uter cfn ii^ply rtdtflnt the titJ^* 
For example. " ' ' • . 

. >EOIT TITLE / 
>T0 JOHN ^ 

nialiM JOHN the title t)f the procedure m tatter uhtt It uae before, . EDIT 
TITLE can only be used uhen editing or defining a procedure. 

EITHER " ^ r 

lakes ttto inputs and outputs TRUE if at letst one it true ^and FALSE 
'if both are false. Both inputs mist be conditionals (evaluate to either 
TRUE or FALSE). 

ELSE' ~ ~ - ■ 

Can be Wd uith IF and THEN to iIIom an atternttlve couref of 
action to take place if the conditional in an IF-THEN pair it FALSE. 
IF :X>5 THEir PRINT "GOOD aSEf?RINT "BAD . 

EMPTYP ^ ^ 

Takes one argutent. Outputs TRUE if the argutent ie tht etpty Mord 

or the empty I i^tY FALSE otherMjse, n \ 

END • * ^ c *' 

Takes no inputs^ Tells the coii»put.r that you W%Bfiit>^ed.def inliia 

or editing^ procAure. 

takes two inputs .and. outputs TRUE If both arguMnt. .valuat. to b. 
the same thing. 0th.rHi8e outputs FALSE. 

EQUAL "JOHN "JOHN . outputs TRUE . 
EQUAL 2 1+1 outputs TRUE 
EQUAL 1 3 ' outputs FALSE 

ERASE (ER) 

Takes one input, the name of a procedure, and .rases that procedure 
from the workspace, 

ERASE ALL (ER ALL)* 

Cli^rs out the entire workspace. 

ERASE ARRAY HER ARRAY) ^ 

Takes one input, the^name of an array, and erases it fro* the 

workspace. 

ERASE ARRAYS (ER ARRAYS) , t . ' ; 

Takes no inputs. Erases all arrays in the workspac. (arrays cannot 
be saved in the filing systew). ^ . 

ERASE BURY (ER BURV) 
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Takes one input, the naie of a buried procedure (or ALL) and 
unburies it (or all buried procedures)^ See BURY* 

ERA^ FILE (ER FILE) 

TaKes one input, the nane of « file, and re»ovet it froM the fiio 
system. . ^ • 

ERASE LINE (ERL) 

Takes one input, a line number, and gets ri(| of that Mne. Can 
only be used Mhile defining or editing* 

ERASE NAMe' jER NAt€) 

Takes one input, a nakie^ and eratit that nM^ frtw tht uorKtpac*. 

ERASE NAtlES (ER NAFIES) * 
Erases all defined naiaes. 

ERASE PROCEDURES (ER PROCEDURES) 

Gets rid of all procedures (but leaves thejitmes,) 

ERASE STEP (ER STEP) 

Takes one input, a procedure name (or ALL) and causes that 
procedure (or all STEPpsd procedures) to no longer be traced (see STEP). 

ERASE TRACE (ER TRACE) 

Takes one input, a procedure nane (or ALL), and causes that 
procedure (or all TRACEd procedures) to no longer be traced (see TRACE), 

ERBRK 

Takes no inputs. Outputs 1 if the previous interruption of the 
procedure being executed was caused by pressing cntrl--G, -1 if it uas 

caused by pressing cntrl-Z, 0 othsr^wise. 

» . «• 

ERCLR 

Takes no inputs. Oeactjvates the ERSET coiMrand. Sftn ERSET, 

ERLIN . 

Takes no inpwts. Outputs the prpcedure line nmiber In which the 
last error occurred. 

ERLOC . ^ 

Takes no inputs. Outputs the location in the coiiitHiter*s core at 
which the last error occurred. 

ERNAH 

J Takes no inputs, outputs the name of the last error. 

ERNUtl , ^ , ^ 

Takes no inputs, outputs the nuiber of the last error. 
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eRPRO 

'Takes no inputs, outputs the naMe of the procedure in which the 
.last error ^Q^urred. 

ERRET 

Takes one input, a line number, and returnt execution to that line 
of the procedure in which the last error occurred. 



ERSET ' 

Takes one input, a procedure name. Causes the procedure given at ^ 
input to be executed every time an error occurs. If this procedure does 
not output, LOGO prints the normal error Message after the execution is 
completed. If the procedure does output, the output is printed instead of 
the normal error message. System bug errors cannot be overidden by* an 
ERSET. 

ERTOK 

Takes no inputs, outputs the "token number" at which the 'previous 
error occurred i-n the given line. Not very usffMl linless the user is 
acquainted with the LOGO.evaluator. 

.FILER- 

TiMs as input a list which contains the desired information to ba 
written into a file. .FILER can be used only when a filt has been opened 
for writing through the use of .OPENR or .OPENA commands. The input to 
.FILER can also be a procedure name, in grtich case the procedure is 
executed and ite output is written into the file. If there is no output, 
nothing is writ'ten. / 

.FILER 

. Takes no inputs, returns as output the current lint of the file 
being read. , FILER pip be used only when a file has been opened for 
reading through the usV of .OPENR. Each time .FILER is used, an internal 
pointer if) the file Is incremented, so that the next use of .FILER will 
raad the next line in the file, and so on. Uhen the end of the file ie 
reached, one blank line will be printed out by .FILER, and then the file is 
. automat ijcalJy closed. If the line being read is a procedure name, that 
procedure will be 'executed. , 

FILE ' • , 

' Special ^w'ord. See PRINTOUT. For information on how to create a 

file, see URITE.' 

; ^ ' • * ) . 

FIRST (F) ^ 
lakes one input, a word or list. It outputs the first character of 
a word or the first word of a list. 

^ V PRINT f IRST "HELLO outputs H 

FORUARO (FO) , 

Takes one input. Tells the floor or display turtle tp move ahead 
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the distance designated in the 'input. 

FORUARO 18 Moves the turtle ahead 16. 

FPRINT 

Like PRINT except that it also prints the top-level brackets around 

a I ist. 

7PRINT [HELLO THERE] 
HELLO THERE 
?FPR1NT tHELLO THERE] 
^ IHELLO THERE] ' 

» 

FPUT • * 

Takes 2 argunents, the second of Mhich must be a^ist (The first 
way be either a word or a list).' Outputs a neu list uhose FIRST is the 
first arg to FPUT and uhose BUTFIRST is the second arg to FPUT. 

FPUT "HERE [I AHJ outputs (HERE I AMI See also LPUT.. ' 

FTOUCH 

Takes no inputs. It outputs TRUE or FALSE depending on whether the 
turtle has activated its forward sensor. 

GET ' 

L Used ,to reference a specific element of an array. Takes up to 4 

I inputs, depending on the dii^nsiont of the array. Thttt inputs are: the 
array name, and the coordinates of the desired tleMtnt. (Coordinates are 
indexed using 0-origin. i.e.. the f^rst coordinate In any diMeneion is 
alMays 9. and the nth element of a dimension has coordinate n-1. GET 
outputs the value of the specified element of the array. As in 
DEFINEARRAY. if the array has more than one dimension, GET and its inputa 
must be enclosed in parentheses. 

GO 

Takes one input, the number of a line in a procedure. It is used 

in a procedure to transfer control to that line. • 

GOODBYE 

Takes no inputs, and is effectively the saMe as HELLO, although 
LOGO responds with a di f ferenkiwssage. Results in a re-initial izattion of 
the user's workspace. . f 

GREATER ' 

Takes two numeric inputs and outputs TRUE If the first •rgument is 
greater than the second; if this is not so It outputs FALSE.- 
• GREATER 4 2 outputs TRUE 

.GUN . 

Takes one arg which is a user number and resets that user's device. 
Its use without that user's consent is deemed highly anti-social. 

HEADING V • - 
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Takes no inputs. It asks the computer to output fhe heading of the 
display turtle, i.e., uhat direction it is pointing in (in degrees} . 

HELLO 

Takes no inpu^ts.^ HELLO tells the computer to .erase eyerything in 
the workspace of the console you are using. HELLO should be typed before 
you begin uriting procedures to clear out any garbage that is left in the 
uorKspace from the last person uho used the*console. 

HERE ^ 

Outputs a l ist of 3/element8, the XCOR, YCOR and HEADING of the 
display turtle. v ^ ' 

HIDETURTLE (HT) 

Takes no ifiputs. Tells the computer to get rid of the little 
triangle uhich is the turtle on your display screen. The turtle uill etill 
lea^ye a track even though you cannot see him. If you don't Mant to see - 
the turtle track, type PENUP (see below). 

HOtlE 

Tak/rs no inputs. Equivalent to SETT IB 0 81. 

IF \ / . i 

Takes one argument Mhich must evaluate to TRUE or FALSE and causes 
execution of the rest of the LOGO Mne to be conditional upon'the 
evaluation q^f the input. If the input evaluates to TRUE, the rest of .the 
line is executed, otherwise control passes directly to the next linbe in 
the procedure, and the remaining part of the line is ignored. 
IF :N-7 THEN PRINT -HEH.0 

THEN Is optional. See also ELSE» 

IFFALSe' (IFF) 

Take* no^inputs. Executes-the reft of the line if the result of « 
the previous TEST was FALSE. 

(FTRi£ (IFT) 

Execute! the rest of the line If the result of the previous TEST 
Mas TRUE. ' , 

ILINE " ^ ^ ^ 

Takes no inputs, outputs the last line typed in at the. console. 

. INOEJt 

/\ Special word which refers to a part, of the file system structure. 
All files belonging to a single user are 9aid to be grouped under that 
user's index. Indices can occur at mul tiple" levels within the user's main 
index. See CRINDEX and PRINTOUT INDEX. 

INTEGER 4 

Takes one numeric input, a floating point number, 'in decimal or 
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'exponential fohm, and outputs this number converted to an integer. 

IS 



SynonyiH for EQUAL. 



LAMPOFF 



LAMPON 



LAST 



Takes no inputs. Turns the' light on the floor turtle off. 



Talces no inputs. Turns the light on the floor turtle on. 



'I 



Talces one input, a uord or list. It outputs the last uord of a 
list or the last character of a uord. 

LAST [QOG AND CAT] -outputs CAT 

LEFT (LT) ' „ • 

' Tal(es<t)ne numeric input. Causes 4hc floor or display turtle to 

rotate ^^0 the left the number of degrees given as input. 

LESS ^ " 

Talces tuo numeric inputs. It outputs TRUE if the first argument is 
less than the. second argument, FALSE otheruise. . 

LEVEL ^ . 

■Talces no inputs. Outputs a number uhlch tslJt "hou many procedures 
deep" current execution is. For example, 
?PRINT LEVEL 

e 

>T0 UHAM ■ ' 

>10 .PRINT LEVEL 
>20 UHAn 
- >END * 
UHAn DEFINED 
?UHAn 

1 ■ 

2 ' . 

etc. (Note that this procedure ui^l I not stop by itself).^ 

LIGHT , ' 

' Takes no inputs. Outputs the amount of light perceived by the 
"eye" of the floor turtle. This is a number betusin 0 and 63, inclusiv«. 

LINE 

Special uord referring to a line in a procedure. See ERASE, 
PRINTOUT and ^DIT. 

LIST « ■ * . 

Takes tuo inputs, each of uhich may be either a uord or a^list. 
Outputs a tuo-elenent LIST uhose elements are its inputs.' This opei-a'tion 
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a ("so accepts a variable number of inputejsee.belou), 

« 

LISTP 



Takes one input. Outputs TRl|E if the Input is. a I ist^ -^ALSE 
otherdise.' . - \\ ' - 

LOCAL : ' , -7- / ^ , . 

' . Takes one input, which is a naie^ Used in a prbcedure it causes 
the scopff of that name to be local to the procedure It. e.. the nawe^ is 
undef ined«outQide of ihe procedure). 

COGIN . . ^ . ' • -/^ V ^ 

Takes one input, a user name (quoted). This '*|eMs thr system Mho 
you are'' and is used by the PEEK conmiand. Also perfdrms an autoinatic USES 
In addition, searches the user's file system for an INIT f i le and performs 
al l commands written Jnto this file (if it. exists), then 9earches for the* 
HAIL f He and bri^its it ouf, if the user sd desires. 

^ ■ , • ■ ■ . ' • 

-LPUi : : ' ' ' > 

Takes 2*arguinints, the second of uhicK must be a l ist. Outputs a 
list^hose LAST is th^e'firs^ arg to LPUT and uhose BUTLAST it the 2nd arg 
to LPUf: . ' ' 

' ^ \ ' LPUT ''HERE [I Am outputs (1 Afl HEREJ . ' 

LTOUCH ' ' . 

' Taljes no Inputs. Outputs TRUE if the floor turtle's left touch 
sensor bas been activated, otherwise FALSE. - 

riAiL ' ^ ' V 

Takes one input, the iiser name of the person to whom the mail is to 
be sent. The computer responds with a Isack-arrdM W\ which indicates that 
anyi^jifig typed in at the console is regardW as.maVlr^^^^^^ the message, 

type a line w period fol lowed by a c^rrlagb return. Th*^^ • 

ebm|;rreted message is then placed i'fi the fl I ihg Si/stem of the user to Mhow 
jt ts sent, contained In a f i le nawed-ftAIL. 

HAKE * 

TaKea two inputs. Th. first input is the NAHE, the second is the 
tHING. MAKE assigns the NAne to the THING. 

nCLEAR 

riusic box command. Takes no input9t clears out the Music box 
buffer. . ^ ^. 

ULEN V • 

Music box command. Takes no inputs, outputs the length of the 
liiusic compi le# for the longest voice. See also VLEN. , 
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• V * . ; . 

fluslc bo)j! cowmand. Takes one Input which specifies to the music * 
bdx hardware hou many voices you.ui9h\to load » Thrs is sifliUar to th^ 
NVQICES /Command in the standm^d music system. This is used in conjunction 
Mith MUTYO to generate real-time music/ « 

nUTYO ' - V .^ 

tlusfc box command for real-^time* music- /Enables ,the^^user to bypass 
the music buffer and tbd PM command. Takes ttio input s» each a music box 
pitch* and makes the music box phay the pi tches; Takes the same pjtc^es as 
NOTE. 

NArtS 

Special Mord. A NA^E is a LOGO uord which is associated with a* 
value, or THING. The use of the special word NAtttS ?t ioW8 the user to 
access all names in the workspace with a single command. See PRINTOUT and 
ERASE. > , ' . ^ 

NEMSNAP 

Takes no inputs. Causes the image currently on the screen not to 
be part of subsequent snaps. Also sets the starting location of subsequent 
snaps to the current position , of the turtle rather than (8,6)« See also 
^DISPLAY and SNAP., * 

NODISPLAY ; ' ^ 

Takes no^inputs and turns off the display. 

NOnUSIG 

Music box command. Takes no inputs^ relisases the music box so that 
others may use tt. 

NOPLOTTER \ ^ 

Takes no inputs and turns off the plottsi^* , 

NOT ; > ' 

Takes one input, which must be a conditional. Outputs TRUE jf the 
input is FALSE and FALSE if the input is TRUE. 

NOTE . . \ ...^ ^ 



Music box command. Takes two numeric J^iputs, the first specifies 
the pitch and the second the duration of one/ff^^of music« Pitches are 
numbered chromaticalty from -^24 to^ with C^frig itddle C. There are 
also three special *'pitchis**j " ^ 

•^28 is a si lence ^ 
' (,-27,-26 are the percussion sounds "boom** and *'ssh** 

-25 is not a valid pjtch. Durations must be between B and 127 " 
units. Each unit is normal ly about 1/8 second. If the duration is zero, 
NOTE generates nothing. If it is 1. generates a pitch I. unit long. If 
greater than T, generates a pitch <duratibn-l> units long^ ^1 towed by 1 / 
unit of rest (so. that music will not sound ^^slurred"). If the pitch is -2& 
or -27, NOTE generates a sound for 1 unit followed by <durdtion-«l> units of 
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NOTURTLE ; : , , , . ' ' . . . u J 

Takes no Input. NOTURTLE. tel Is the ponputer that you arc finished 
with the floor turtle. You must use this coiiiiii,and>t(rre.l ease the turtle 
before, somebne efse cian use it, - 

NOHRAP . ■ ^ 

Takes no inputs. Tells the computer not to dliloM scenes on the 

display to go out of bounds* See URAP. ^ . « 

. Takes 1 input. Outputs TRUE if the Input is a nuwber and FALSE 
otherwise. 

NVOICES . ° . • ^. ^ . 

Takes one input, a number which specifies the voices to which music 
output^irf sent. The music system normal ly multiplexes output among four 
voices, but it is also possible to send, output to only one or two voices, 
using NVOICES: 

NVOICES 1 outputs only to voice 1 , 

NVOICES 2 outputs only to voices 1 and 2 

NVOICES 4 outputs to all four voices (the normal model Since the 
music box is fed at a.constant rate, NVOICES 1 causes the basic unit of 
duration to be 1/4 as long as normal, while NVOICES 2 causes it- to be 1/2 
as long. 



OF 
\. as in: 

.OPENA 



Noise word. Used to separate inputs from commands or operations, 

\ 

' sun OF J 4 



Takes one input, the name of a file (qHOted), and opens the file 
for -writing. The actual writing is done wl.th the .FILEP command, and all 
information, writ ten is added . (appended) onto the\end of the file. None of 
the original contents of the file are altered. U the file given as input 
'does not exist, a new file with the specified nam* wi 1 1 be created, m^- 
which case the command is identical to .OI^NU. \ . ' 

Takes'one input, a file name (quoted) and opens that file for 
reading. Ahe actual reading is done wfth .FILER. Once the file has been 
automatically closed by .FILER. .OPENR must be typed in order to read the 
f i le again. ' 

.OPENU .OPENA, but the writing done with .FILEP is written 

starting at the beginning of the file. The file name which is g'^en as 
input may be a non-existent file, in which case the file is created. If 
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the file already exists, however, the user uill be asked tk delete it 
beforeluritihg. since the old infomation contained in the file uill be 
destroyed by/the input to .FILER. . ^ 

OUTPUT ^^ . ' 

\ Take* one . Input. Can' only be used in a procedurei returns control 
to the calling procedure and outputs the specified arguient* 

PAUSE ^ * V' 

. Takes -no inputs. Uhen the DEBUG switch is on, , executing this 

comwand within a procedure wilJ cause LOGO to pause. The user nay then 
execute any cowwands he Mishes. To reajjie the execution of \hm procedure, 
use the CONTINUE command. . • 

■• PEE((- „ ' ■ . ■■ . •/ '• 

Takes no inputs. Prjnttsysten status information. ' 

PENOOUN'jPD) . 

Takes no inputs. When used, for either a floor turttv or a, display 
turtle, ft causes the turtle to draw a line when It moves. 

PENP ' 

Takes no inputs. , Used with the display turtle, it outputs TRUE if 
the pen is down, FALSE if the pen is up. 

PENUP (PU) 

Takes no inputs. Uhen used with either a f^por turtle or display 
turtle, causes the turtle to not draw a line when it moves. 

PLOTTER 

Takes no inputs, turns on the plotter. All other plotter commands 
are the same as display commands. However, certain display cokmmands do 
not apply to the plotter and will be ignored if typed to the plotter. 
Host of these arfl^airly obvious; they linclude: aEARSCREEN. MIPEaEAN, 
WRAP, HIOETURTLE, SHOUTURTLE, SNAP. Ul RE. and DISPLAY. Thi plotter also 
has a more restricted argument range than the displays. NOPLOTTER turns 
off the plotter. 

PM 

Music box command. Takes no inputs. Causes'^the output of previous 
NOTE commands to be played on the music box. As the musip it played, it \n 
erased form temporary storage and must be recompilad before bvti^g played 

again. . 

PRINT (PRI • 

Takes one input, which evaluates to either a uord or a list. 
Prints out the evaluated input on the consolm* 

?PR SUM 4 4 
8 

?PR [SUM 4 41 
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sun 4 4' 

PRINTOUT 4Pp)^ • / • 

Tdkes^one input, the name of a procedure, and prints the text of 

the procedure on the console/ * f 

* . . 

PRINTOUT ALL (PO ALL) 

Takes no inputn^and prints out ail naiitt, proctdurett and arrays 
currentjy defined* in the workspace. 

• . 

PRINTOUT ARRAY (PO ARRAY) ^ ^ 

Takes one input, the name of an array, and prints o*ut the array's 
dimensions 'and type.. 

PRINTOUT ARRAYS (PO ARRAYS) 

Takes n'o inputs. Performs PO ARRAY for all cur^rsntly defined 
arrays. » - ^ 

PRINTOUT FILE (PO FILE) . fi 

Takes as input a file name and prints out tha contents of the file. 

PRINTOUT INDEX (POD 

Takes no inputs. Prints the names of all files in the^user*s 
current index (see USE). 

PRINTOUT Line (pol) 

Takes one input, a line number, and prints out the specified line. 
Can be used only while defining or editing. 

PRINTOUT NAriES (PO NAflES) S 

Ho inputs. Prints out all currently defined names and their 
values. * 

.PRINTOUT PROCEOURES 

No inputs. Prints out the definitions of all procedures currently 
defined in the workspace. 

PRINTOUT TITLE (POT) 

No inputs. Used only while defining or editing, prints the tit la 
of the procedure currently being defined/edi ted^ 

PRINTOUT TITLES (POTS) 

Takes no input ii. Printe out the titles of all procedures defined 
in the workspace. . 

PRINTOUT TREE (PO TREE) ' 

Takes no inputs. Prints out the tree structure of the filing 
system, starting iSith the current index. See SETINOEX. 

PROCEDURES , ^ ■ 
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Special word* See PRINTOUT and ERASE* 

PRODUCT . . t5 ^ 

fakes two numeH^" inputs and outputs their product* 
PRINT PRODUCT 2 3 prints B. 

^ QUOTIENT 

ir Takes tuo numeric inputs and outputs their quotients (The first 
input is divided by the second)*- 

PRINT QUPTIENT k 2 prints 2. • 

RANDOn - f 

No inputs* Outputs a one-digit random inttgsr. 

READ ^ ^ < . ^ . 

Takes one input* the name of an existing file (stored ton disk), 
and* reajls it into the uorkspacft* ' 

READPTR' \ • ^ 

Takes no inputs* Reads into the Morkspacs from jthe paper tape 

reader* 

. . ' * 

REHAINOER " 

Takes tuo numeric inputs, outputs ^the remainUer'of the first number 
divided by the second: 

'REMAINDER 27 5 outputs 2 a r -^'^ 

REQUEST , 

No inputs* Uhen encountered in the enecution of a procedure,* 
causes LOGO to pause and uait for a line to be typed in* This input is 
treated as a list and printed on the console. 

RIGHT (RTl 

Tsf^es one numeric input. Commands the floor or display turtle to 
turn to the right (clockuise) the number of degrees uhich you give as an 
input* 

RIGHT 38 tells the turtle to turrf 38 degrtes to the right* 

RTOWCH jl 

Takes no inputs*^ Checks to see uhether the right sensor on the 
floor turtle has been activated by touching something. If so, outputs ^ 
TRUE, otherwise FALSE. 

" ' ^ ft ^ 

RUN ' 

Takes one input, a list^ and evaluatss this list just is if it uere 

typed in at the console* 

?RUN (PRINT sun 18 51 ^ 
23 

SEND 
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Takes tuo inputs. Tht first is tht nunbsr of ^« consold, the second 
is a list Mhrch is printed out as a messagp on the specified console. Used 
to send messages to users currently on thf sustem. 

SENTENCE (SE) 

Takes tMo inputs. If both are lists it puts the elements of the 
lists together to make a single list and outputs that list. If either of 
its inputs is not a list it first changes the input to a one*element Tiet 
and then proceeds as above. 

SENTENCE IFOO] IFOO BARl outputs IFOO FOQ BAR1 
SENTENCE tUHAT IS YOUR] '•NAUE? outputs lUHAT IS YOUR NAME?J 
SENTENCE also has the .variable number of inputs feature. 

^. (SENTENCE [PIECESl "OF '•A IBIG LISTl) 
outputs [PIECES OF ^A BIG LIST! 

SETASIZE ^ 

^Used to al locate additional space for arrays* Takes one input;, ^he 
amount of space to be allocated, in uods (every Mord stores one pointer 
array element, every tuo Mordt store one integer or floating point array 
• lementJ The maximum input is aprroximately 11080, which makes it . . 
possible to expand array space by a factor of three. It should be 
remembered, however, tha( the use of SETASIZE involves a re-initialization 
^of the user's uorkspace, which means that a ''UELCOtl^ TO 111000** message 
will be printed upon completion of the command* 

SETHEAOING 

Take^ one numeric input. Specifies the direction (in degrees) in 
which the display turtle points* Zero is straight up.' 

SETINOeXiSETI) 

Takes one inpui, the name of an index. The input may be a list if 
there are one or more indices separating the desired index from the current 
one. In this case the list contains the names of all the indices on the. 
•^path** which must be followed through the file tree in order to reach the 
new index. This index becomes the new root index, which means that all 
filing commands such as POI and PO TREE refsr only to that portion of the 
file system below the. desired ind^x* > 

SETTURTLE (SETT) 

Takes one input which is a list of 3 numbers. This input .assigns, 
in orders the x-^coordinate, the y-coordinate, and the heading of the 
d^play turtle* ^ 

SETX 

Takes one numeric ^nput. Moves the display turtle horizontally to 
the specified coordinate. 

SETXY ' ^ , 

Takes two numeric inputs* Moves the display turtle {o the position 
designated. 

.10 " 
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SETY ' 

Takes one numerical input. It Moves the display turtit vertical ly 

to the specified coordinate* 

SHOUTURTLE (ST) 

Takes no inputs. It tells the coMputer to put the display turtle 
(a little triangle) on the display screen, 

SIN " - . 

Takes one numeric input (representing degrees) and outputs the sifie 
of the specified angle. ^ ^ 

SNAP 

Takes no inputs* Outputs a reference to ''tht stuff on the display 
screen*" For eKample, 

riAKE TIC SNAP causes :PIC to refer to Mhatever is 
Currently on the screen* Later you can cause another copy to appear by 
saying: . • * ^ 

DISPLAY : PIC or erase it by saying 

UIPE :PIC 

Each SNAP has associated uith it a *'etarting location** and an 
"^ending location** uhich determine uhere the picture appisrs Mhen you say 
DISPLAY. The starting location is normally th ctnter of the screen (but 
see also NEUSNAP) and the ending location is the position of the turtle 
when the SNAP command is given. SNAP*s cannot be saved Hith the URITE 
command (they are ignored)* 

STEP 

takes one input, .ths name of a procadure tor ALL)* Causes the 
procedure to be TRACEd, and in addition, before each 4ine of the procedure 
is executed, theHine is typed out and LOGO uaits for the usar to respond* 
There are three options^ 

1) Typing a carriage return xagses the line to be executed and goes 
tbn to the next I ine. 

(2) Typing cntrl«*G terminates execution (as alMSys)* 

(3) Typing cntrl-^Z generates a PAUSE* Mhlch may be ixited by usin^ 
the CONTINUE command. 

A STEP is removed by typing ERASE STEP <procedure name (or ALL)>« 

STARTDI5PLAY ^ • \ 

Takes one input, either 8 or 1* Tells the computer to give you a 
difplay turtle. The input determines the size of the display* 8 is a 
half-size display, 1 is a fulUsize display* 

STOP ; * 

No inputs* Used in a procedure, it terminates execution of the 
procedure and transfers control to the cal ting procedura* 

STORE 

Used to assign a value to a^ specific elemant of an array* Takes 
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the same number of inputs as the corresponding OEFINEARRAY command which 
created the array. These inputs are: the array name^ the coordinates of 
the desired etement, and the value to be assigned. Zero-*origin indexing is 
in effect here also (see GET). If the array has more than one dimeheion. 
STORE and its inputs must be enclosed ih parentheses. 

SUM 

Takes two numeric inputs and outputs their sum. Also accepts 
^multiple Inputs (see be I ou). \ 

SYSPR 

Takes as input a list uhich is printed out on all system consoles 
currently in use. 

TE,ST - , V " 

' A command it takes an argument (nhich must evaluate to TRIE or 

FALSE) and puts the result in a test box.' Ypu can then ask IFTRUE or 

IFFALSE'to look in the box.- , 

TEST 2-2 IFTRt£ PRINT "TRUE prints TRUE 
TEST 2-5 IFTRUE PRINT "TRUE prints nothing 

X^XT V - ^ ' • , 

' Takes one input, a procedure name* and outputs the text of the 
procedure as a list. (Note the distinction between TEXT and PRINTOUT. The 
latter is a command; it does not output)* 

THEN • 

Noise word, which separates the conditional clause of an IF<- 
expression from the statement to be conditional I y executed* (see IF.) 

THING ' , 

Takes one input* a name, and outputs the value aesighed to that 

name* 
TIME 

Outputs a 3-elemerit list which is supposed to be HR/MIN/SEC. 
Curently un implemented* 

TITLE ^ 

Special word, refers to the title of a procedure* See PRINTOUT and 
EDIT* ; 

TO , 

Used to define procedures. Takes a variable number of inputs, the 
first of which is the name of the procedure to be defined* The rest are 
names of inputs to the procedure* 

TOOT 

Takes one input. Tells the floor turtle to toot its horn <input> 

times; 
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TOPLEVEL ■ " 

Takes na inputs. Used (^ily in a procsdurt, jt\rtturn"s controti in c. 
the-procedure i mined i ate I y 1o the top level. * ) • , 

TRACE ^ . " 

y Takiia one input which U^a procedgre naiie kr* ALI|f).> Causes 
computer to prijij^out a. Message each tiiit the proctdurt J « extcuted,: ^ 
indicating the inputs to .the procedure and the outfiut, if any.* To gtt rid 
of it. type ERASE TRACE.J0I lowed by, thr procedure na^^^ 

TURTLE t " . , ■ ^ . x"- ■ 

Takes one numeric input, the numtiitr* of th» turf le to be uiied. ^ 
Gives the user access to t*p specif itd tuftN- Although it ii r>^^^ to 
have up to four turtles on the.syitepi, noriaMy only 1 and 2 will be' 
acceptable turtle nuibcM/^ / ' * 

Takes one input, 9 t(fvice specif iteation. See .TYO. The next piece 
of inforntation received from the device ifi interpreted is e*niHliber and 
given as output. ^ " ^ \ , 

.TYO ■ . . ' ./'^ ' 

Takes two inpiuts. The first fs a device' specif ice ticMi.%Th is wy 
be either a device nunber or device naee; The devli:e neMe tOGO recognizee 
are the fol lowing: ' 

"LIGHT for the light box ^- 

"TURl ^ ^ for turtle 1 

"TUR2 for turtle 2 ^ ^ \ ; 

"nUSIC ^ ^ for the imisic box i ^ 
•^PLOTTER lor the p I ot tec^ ^ V • ' 

**TJY for your own console ' . 

The second input is 9 character cpde which specifies a character to 
be relayed to the given device as output. ■ ■ 

' . ' . - ■ ,. , . ■ '\ ■ 

TYOUAIT " - 

Siwilar to CTYOUAIT, but takes on. .K^a input (Mhfch cox.8 f ir.t) . 
This input is the specification of the dsvic. to wiil for. This, 
specifications ar. th. sans as for .TYO. « * , 

TYPE ■,• .... .. ■■ : . - , ' ■ '. ■ 

EssBntially th. siiM. as PRINT, but does not ctrrlag. r»turn. 

TyPEIN 

Equivalent to FIRST of REOUEST* ' • " 

USE ' ' ^ . s 

One input, which is the niine of. an index. If .this is not the 
user's rqot index, the index May be specif ied by a list whijch contains the 
••path** of indices through the til« tree leadifi^ to the 'desired index. Thie 
coMMand specifies the default index to be used for READ end URITE 
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coMRiahds; as ue\ I as POI and PC TREE, , • 

,«RSi0N ; , 

" No inputs^ Outputs a nuabsr which tails which vsrsion of LOGO is 
iturrsntly running, . ^ 

VLEN . ' ' " ; V 

» ffusic box cosnand. Takes ho inputs. Outputs the tot* I length of 
music cofpi led for the current voice.^ $ ' 

ybicE ' ' " 

: Music boK coMaand. Takes one input which must be a number between 
'^l drid'4, Oirects the output ojF subsequent NOTE commands to the various 
yoicejs. The current voice remains the same for alt subsequent NOTE 
commands until the ne>ct VOICE command is given. If no VOICE command ie 
given, the 8|||stem outputs to voice number 1, *^ 

" ' ■ ' • - ' ' ' ■ r ■ 

UAIT / \^ ■ 

■ /- Takes one numeric input, causes LOGO to pause for the specified 
Ipngih of time Igiven in l/68ths of a second,) ,. 

'uipe' ( ^ - . "■ ^ ^ 

Takes ona input, a sna^, and erases at I appearancei of the snap 

from the displag screen, * - 

HIPECLEAN . - * ^- : ' 

' V Takes np. inputs. It tells the cc^Nputer to get ^^ o^ ev(erythi7||| on 
the screen, 'l%avi*ig the turtle where-, it it* \^-< ^ 

'mOTO- -^' ■ ^ ^ ■ ■ _ V. ■ '^-^ 

Takes two inpuisj^ whicl^ must bs words, UORO takes the two' ijnpute 
. and puts them together to .make one word* ^ ^ 

MOROf* V , - ' ' ^ 

Takes one input and tests to see If the tnput is j|;,Mord* If so, 
outputs TRUE, otherwise FALSE, 

WRAP . V-^' ■ A ^ • • ..A'- 

Takes no inputs^ Causes an Image which gcKis out of bounds on .tW 
^ display screen to "wrap around** to "the other side, . a ' 

WRITE '\ : :'\ '. . 

Takes one, input, the fiame of a file to b« oreated. Saves the 
i:ur ran t *con tents bi the workspace under that file rUMie, ^ 
will put everythinsf'ln your workspace into a file naaed X, 

MRITEPTP';. ,.' ' . ■ ■ ' ' •• ■ .. .' 

Takes no inputs. It urit«s tiM coAtsntf of your iwrkspace onto « 
paper tape, for permanent storage. ' (Hake iur, th, paper tape printer is 
readul];;;. 
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XCOR 

Takes no inputs. Outputs tht praftnt X-coordlnttf of th« di splay 



turtle. 
YCOR 



Takes no inputs. Outputs the present Y-coordinate of the turtle. 



VARIABLE NUriBER OF INPUTS . 

Certain primitives can take a variable muster of inputs. To use 
this feature, the primitive and its inputs must be grouped together \n 
parentheses. For example, 

(Sm 5 S 7 8) outputs 26 

The primitives having thie feature are; 

FPRINT 

FPUT -(FPUT "A "B "C lUOUJ outputs [ A B C UOUl 
LIST , 

LPUT - (LPUT "A "B "C lUOHl) putputs WOOA B C J 
PRINT 

PRODUCT . 
SENTENCE 

SING - Number of Inputs must be even 

sun 

TYPE , - 

UORD . 

SPECIAL CHARACTERS 

• Used for comment. Anything appearing after It on a nne is Ignored. 
tf Takes one input which must be a Mord and evaluates its Input, e.g., 

#(UOflD "POOH 5) Mill exscuU the procedure named P00H5. 

( ) used for grouping. 

[ 1 Used to indicate lists. 

* infix PRODUCT 
+ infix sun 

- infix DIFFERENCE ^ 
/ infix QUOTIENT 

: Same as THING, except that it does not evaluate its arouient. 

> infix GREATER 
< infix LESS 

- infix EQUAL 
\ infix MOO 

infix MAKE, ie., "A 5 is equivalent to MAKE "A S 

tA Echoes as carriage return 
TB Echoes as blank O 
tG Break 

tH Echoes as backspace 

tl Echoes as tab 

tj Echoes as linefeed 

tQ" Superquotes the foflouing character (i.e. prevents it fi*oi being 
evaluated) 
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tZ Uhen DEBUG is off it. is equivaltnt to tG. Uhtn DEBUG it on* it pfMM* 

a pause. , * - 

EDITING CHARACTERS • ^ 

rubout Deletes' the pevious character. t " * 

tU Deletes the previous word. 

tY Places^he previoiis line typed in tht edit buffer > 
t4hen you have something in the edit buffer (after using EDL or tY) 

the fol lowing can bemused; \ 
tC Copy the next character. * p< 

tN Copy the next word. I 
tS Skip the next word. 

tR Copy the rest of the- edit buffer. ' ' / 
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